
<!DOCTYPE html>
<!--

    Copyright (c) 2017, 2019 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->
<!-- Portions Copyright [2019] [Payara Foundation and/or its affiliates] -->
<html lang="en">
  <head>
    <meta charset="utf-8"/>
    <title>update-node-dcom</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="css/style.css" rel="stylesheet">
    <script src="https://use.fontawesome.com/96c4d89611.js"></script>
  </head>
  <body>
<table id="doc-title" cellspacing="0" cellpadding="0">
  <tr>
  <td align="left" valign="top">
  <b>update-node-dcom</b><br />
  </td>
  </tr>
</table>
<hr />

<table width="90%" id="top-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>
		<td align="left">
		<a href="update-node-config.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="update-node-ssh001.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class=" vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>


<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p><a id="update-node-dcom-1"></a><a id="GSRFM789"></a><a id="update-node-dcom"></a></p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_update_node_dcom">update-node-dcom</h2>
<div class="sectionbody">
<div class="paragraph">
<p>updates the configuration data of a node</p>
</div>
<div id="sthref2290" class="paragraph">
<p>Synopsis</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin [asadmin-options] update-node-dcom [--help]
[--nodehost node-host]
[--installdir as-install-parent] [--nodedir node-dir]
[--windowsuser windows-user] [--windowsdomain windows-domain]
[--force={false|true}]
node-name</code></pre>
</div>
</div>
<div id="sthref2291" class="paragraph">
<p>Description</p>
</div>
<div class="paragraph">
<p>The <code>update-node-dcom</code> subcommand updates the configuration data of a
node. This subcommand requires the Distributed Component Object Model
(DCOM) remote protocol to be configured on the host where the domain
administration server (DAS) is running and on the host where the node
resides. The DCOM protocol is available only on Windows systems.You may
run this subcommand from any host that can contact the DAS.</p>
</div>
<div class="paragraph">
<p>This subcommand can update any node, regardless of whether the node is
enabled for remote communication. If the node is not enabled for remote
communication, the subcommand enables DCOM communication for the node
and updates any other specified configuration data.</p>
</div>
<div class="paragraph">
<p>Options of this subcommand specify the new values of the node&#8217;s
configuration data. The default for most options is to leave the
existing value unchanged. However, if this subcommand is run to enable
DCOM communication for a node, default values are applied if any of the
following options is omitted:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>--windowsuser</code></p>
</li>
<li>
<p><code>--windowsdomain</code></p>
</li>
</ul>
</div>
<div class="paragraph">
<p>By default, the subcommand fails and the node is not updated if the DAS
cannot contact the node&#8217;s host through DCOM. To force the node to be
updated even if the host cannot be contacted through DCOM, set the
<code>--force</code> option to <code>true</code>.</p>
</div>
<div class="paragraph">
<p>This subcommand is supported in remote mode only.</p>
</div>
<div id="sthref2292" class="paragraph">
<p>Options</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">asadmin-options</dt>
<dd>
<p>Options for the <code>asadmin</code> utility. For information about these
options, see the <a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a> help page.</p>
</dd>
<dt class="hdlist1"><code>--help</code></dt>
<dt class="hdlist1"><code>-?</code></dt>
<dd>
<p>Displays the help text for the subcommand.</p>
</dd>
<dt class="hdlist1"><code>--nodehost</code></dt>
<dd>
<p>The name of the host that the node is to represent after the node is
updated.</p>
</dd>
<dt class="hdlist1"><code>--installdir</code></dt>
<dd>
<p>The full path to the parent of the base installation directory of the
\{product---name} software on the host, for example,
<code>/export/glassfish3/</code>.</p>
</dd>
<dt class="hdlist1"><code>--nodedir</code></dt>
<dd>
<p>The path to the directory that is to contain \{product---name}
instances that are created on the node. If a relative path is
specified, the path is relative to the as-install directory, where
as-install is the base installation directory of the \{product---name}
software on the host.</p>
</dd>
<dt class="hdlist1"><code>--windowsuser</code></dt>
<dt class="hdlist1"><code>-w</code></dt>
<dd>
<p>The user on this node&#8217;s host that is to run the process for connecting
to the host through DCOM. The default depends on whether this
subcommand is run to enable DCOM communication for the node:<br></p>
<div class="ulist">
<ul>
<li>
<p>If the node is already enabled for communication over DCOM, the
default is to leave the user unchanged.</p>
</li>
<li>
<p>If this subcommand is run to enable DCOM communication for the node,
the default is the user that is running the DAS process.<br>
If the <code>--nodehost</code> option is set to <code>localhost</code>, the <code>--windowsuser</code>
option is ignored.</p>
</li>
</ul>
</div>
</dd>
<dt class="hdlist1"><code>--windowsdomain</code></dt>
<dt class="hdlist1"><code>-d</code></dt>
<dd>
<p>The name of the Windows domain that contains the user that the
<code>--windowsuser</code> option specifies. The default depends on whether this
subcommand is run to enable DCOM communication for the node:<br></p>
<div class="ulist">
<ul>
<li>
<p>If the node is already enabled for communication over DCOM, the
default is to leave the domain unchanged.</p>
</li>
<li>
<p>If this subcommand is run to enable DCOM communication for the node,
the default is the name of the host on which the subcommand is run.</p>
</li>
</ul>
</div>
</dd>
<dt class="hdlist1"><code>--force</code></dt>
<dd>
<p>Specifies whether the node is updated even if validation of the node&#8217;s
parameters fails. To validate a node&#8217;s parameters, the DAS must be
able to contact the node&#8217;s host through DCOM. Possible values are as
follows:<br></p>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>false</code></dt>
<dd>
<p>The node is not updated if validation of the node&#8217;s parameters fails
(default).</p>
</dd>
<dt class="hdlist1"><code>true</code></dt>
<dd>
<p>The node is updated even if validation of the node&#8217;s parameters
fails.</p>
</dd>
</dl>
</div>
</dd>
</dl>
</div>
<div id="sthref2293" class="paragraph">
<p>Operands</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">node-name</dt>
<dd>
<p>The name of the node to update. The node must exist. Otherwise, an
error occurs.</p>
</dd>
</dl>
</div>
<div id="sthref2294" class="paragraph">
<p>Examples</p>
</div>
<div class="paragraph">
<p><a id="GSRFM790"></a><a id="sthref2295"></a></p>
</div>
<div class="paragraph">
<p>Example 1   Updating the Host That a Node Represents</p>
</div>
<div class="paragraph">
<p>This example updates the host that the node <code>wpmdl1</code> represents to
<code>wj01</code>.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; update-node-dcom --nodehost wj01 wpmdl1
Command update-node-dcom executed successfully.</code></pre>
</div>
</div>
<div class="paragraph">
<p><a id="GSRFM791"></a><a id="sthref2296"></a></p>
</div>
<div class="paragraph">
<p>Example 2   Forcing the Update of a Node</p>
</div>
<div class="paragraph">
<p>This example forces the update of the node <code>xkyd</code> to enable the node to
communicate over DCOM.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; update-node-dcom --force xkyd
Warning: some parameters appear to be invalid.
Could not find a remote Glassfish installation on host: xkyd.example.com at
C:\glassfish3\glassfish
Continuing with node update due to use of --force.
Command update-node-dcom executed successfully.</code></pre>
</div>
</div>
<div id="sthref2297" class="paragraph">
<p>Exit Status</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">0</dt>
<dd>
<p>command executed successfully</p>
</dd>
<dt class="hdlist1">1</dt>
<dd>
<p>error in executing the command</p>
</dd>
</dl>
</div>
<div id="sthref2298" class="paragraph">
<p>See Also</p>
</div>
<div class="paragraph">
<p><a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a></p>
</div>
<div class="paragraph">
<p><a href="create-node-config.html#create-node-config-1"><code>create-node-config</code>(1)</a>,
<a href="create-node-dcom.html#create-node-dcom-1"><code>create-node-dcom</code>(1)</a>,
<a href="create-node-ssh.html#create-node-ssh-1"><code>create-node-ssh</code>(1)</a>,
<a href="delete-node-config.html#delete-node-config-1"><code>delete-node-config</code>(1)</a>,
<a href="delete-node-dcom.html#delete-node-dcom-1"><code>delete-node-dcom</code>(1)</a>,
<a href="delete-node-ssh.html#delete-node-ssh-1"><code>delete-node-ssh</code>(1)</a>,
<a href="install-node.html#install-node-1"><code>install-node</code>(1)</a>,
<a href="install-node-dcom.html#install-node-dcom-1"><code>install-node-dcom</code>(1)</a>,
<a href="install-node-ssh.html#install-node-ssh-1"><code>install-node-ssh</code>(1)</a>,
<a href="list-nodes.html#list-nodes-1"><code>list-nodes</code>(1)</a>,
<a href="uninstall-node.html#uninstall-node-1"><code>uninstall-node</code>(1)</a>,
<a href="uninstall-node-dcom.html#uninstall-node-dcom-1"><code>uninstall-node-dcom</code>(1)</a>,
<a href="uninstall-node-ssh.html#uninstall-node-ssh-1"><code>uninstall-node-ssh</code>(1)</a>,
<a href="update-node-config.html#update-node-config-1"><code>update-node-config</code>(1)</a>,
<a href="update-node-ssh001.html#update-node-ssh-1"><code>update-node-ssh</code>(1)</a></p>
</div>
</div>
</div>

<hr />

<table width="90%" id="bottom-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>		
		<td align="left">
		<a href="update-node-config.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="update-node-ssh001.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class="vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>

<span id="copyright">
        <img src="/resource/reference/img/eclipse_foundation_logo_tiny.png" height="20px" alt="Eclipse Foundation Logo" align="top"/>&nbsp;            
        <span >Copyright&nbsp;&copy;&nbsp;2019,&nbsp;Oracle&nbsp;and/or&nbsp;its&nbsp;affiliates.&nbsp;All&nbsp;rights&nbsp;reserved.</span>
</span>

</body>
</html>
